Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d6/kgraf.arc/KWIKGRAF.HLP

Text File | 1989-04-01 | 10KB | 300 lines

KWIKGRAF Version 1.00 Help Screens
@1,KWIKGRAF commands, Running KWIKGRAF from DOS
@3,     PIECHART Summary
@4,     PICTOGRAM Summary
@5,     HISTOGRAM Summary
@6,     3-D Bar Chart Summary
@7,     SCATTERPLOT Summary
@8,     TIME SERIES PLOT Summary
@9,Running KWIKGRAF from dBASE III
@10,Using a KWIKGRAF command file - From DOS or KWIKGRAF menu
@12,The KWIKGRAF Menu
@13,How to Enter Data into KWIKGRAF
@14,    Enter data from an ASCII file
@15,Set up MONITOR, COLORS, and DEFAULT PATH
@16,SHAREWARE explained
##1

                               KWIKGRAF COMMANDS

The KWIKGRAF command line specifics what database to use, which graph to
draw, which variable in the database to use, a title, and other information
specific to the graph being displayed.  A command line looks like this:

DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="THIS IS MY TITLE"

Important points:

    1. No blanks between the key word (i.e. DATA), the equal sign and
       the specification (i.e. EXAMPLE)
    2. Case does not matter.
    3. Titles MUST be enclosed in quotes

In this example, the database is specified by the DATA keyword, and the
database name is EXAMPLE.  The GRAPH keyword specifies a PIE chart.  The X
variable is has the field name STATUS, and the TITLE is "THIS IS MY TITLE".

##2

Required KWIKGRAF keywords for drawing a graph:

    DATA=          Specified datebase name

    GRAPH=         Specifies graph type. This can be PIE
                   HISTOGRAM, PICTOGRAPH, SCATTERPLOT,
                   TIMEPLOT or 3-D HISTOGRAM.  These can be
                   abbreviated to PIE, HISTO, PICTO, SCAT,
                   TIME and 3-D.

    X=             Specifies field name of variable to use

If two variables are required, as in SCAT and 3-D, then a required
keyword is:

    Y=             Specifies second field name

##3

                             PIE CHART SUMMARY


Required Keywords: DATA=databasename
                   GRAPH=PIE
                   X=fieldname

Optional Keywords: TITLE="enclose title in quotes"

For example:

KWIKGRAF DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="Pie Chart on Status"



##4

                               PICTOGRAM SUMMARY

Required Keywords: DATA=databasename
                   GRAPH=PICTO
                   X=fieldname
                   IMG=imagefile

Optional Keywords: TITLE="enclose title in quotes"

For example:

KWIKGRAF DATA=EXAMPLE GRAPH=PICTO X=STATUS IMG=PERSON TITLE="Status"
##5

                               HISTOGRAM SUMMARY


Required Keywords: DATA=databasename
                   GRAPH=HISTO
                   X=fieldname (must be numeric)


Optional Keywords: TITLE="enclose title in quotes"


For example:

KWIKGRAF DATA=EXAMPLE GRAPH=HISTO X=AGE TITLE="Histogram on Age"

##6

                             3-D BAR CHART SUMMARY


Required Keywords: DATA=databasename
                   GRAPH=3-D
                   X=fieldname
                   Y=fieldname

Optional Keywords: TITLE="enclose title in quotes"


For example:

KWIKGRAF DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"

##7

                              SCATTERPLOT SUMMARY


Required Keywords: DATA=databasename
                   GRAPH=SCAT
                   X=fieldname (must be numeric)
                   Y=fieldname (must be numeric)

Optional Keywords: TITLE="enclose title in quotes"


For example:

KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"


##8

                            TIME SERIES PLOT SUMMARY


Required Keywords: DATA=databasename
                   GRAPH=TIME
                   X=fieldname (must be numeric)

Optional Keywords: TITLE="enclose title in quotes"


For example:

KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"
##9

                        RUNNING KWIKGRAF from dBASE III



From within dBASE III, you can cause a KWIKGRAPH graph to be produced by
using the RUN command.  For example:

.RUN KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"

For this to work, the KWIKGRAF program needs to be in the same subdirectory
as dBASE III.  Otherwise, you need to place the path name before the
KWIKGRAF command.

##10
                        USING KWIKGRAF COMMAND FILES


Create a file containing a series of KWIKGRAF commands Here are some
examples:

KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
KWIKGRAF DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"

If your command is too long for a line, place a "+" at the end of the line.
For example:

KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 +
TITLE="Time1 by Time2"

continued . . .
##11

                     USING KWIKGRAF COMMAND FILES continued


To cause text, such as what you are reading to be displayed, place the
command @DISPLAY on a line, followed by all of the lines to display, and
end the display with the command @END.  If you place the keyword BORDER
on the line with @DISPLAY, a border will appear around the text.

To run a command file, enter the following command from DOS.

KWIKGRAF FILE=commandfile


Command files should have a .KG extension.


##12

                               The KWIKGRAF Menu
                                   ----------

If you enter the KWIKGRAF command from DOS with no other keywords, you will
be in "menu" mode, where you can interactively create graphs.

You can choose the "G" option to run KWIKGRAF command files.

There are a few more options you can choose from the menu mode than from the
command mode, such as specifying certain minimums and maximums for graphs.
You can also run two other KWIKGRAF programs, KWIKDATA and KWIKUTIL

KWIKDATA - create a DATABASE file, enter data, manipulate data.

KWIKUTIL - Create an IMAGE, set colors and default disk, output reports.
##13

                               HOW TO ENTER DATA

Data may be entered from the keyboard, or from an ASCII text file. Data
already stored in a dBASE III file may also be used.

                        ENTERING DATA FROM THE KEYBOARD

STEP 1:Create the structure of your database by selecting the "CREATE".
Define names, type and width of each field.

STEP 2:Answer "Y" to "Enter data now?(Y/N)" question, for choose Enter DATA
from KEYBOARD.

STEP 3:The "EDIT" option to make corrections.

##14
                     ENTERING DATA FROM AN ASCII TEXT FILE

Create a database structure using the CREATE option. This structure should
match the columns of data in the data file. For example, your data is in a
file named "MYDATA.TXT". A database structure could be created using the
following format:

Field Type  Width  Dec

NAME    C    10
AGE     N     2     0
BDATE   D     8
 ^      ^     ^     ^
 │      │     │     └─────────────Number of decimals in numeric data
 │      │     └───────────────────Columns where data is found
 │      └─────────────────────────Data type
 └────────────────────────────────Variable (field) name

This implies NAME is in columns 1-10, AGE in cols 11-12 and BDATE in cols
13-21. NOTICE:The format MUST be inclusive with respect to column numbers. DO
NOT SKIP COLUMNS when specifying where data is located.
##15

                   SET UP TYPE MONITOR, COLORS, DEFAULT PATH


In the KWIKUTIL module, select the option to set up the default disk drive or
path, the type monitor you are using, and the colors to use.

If you are using a Hercules (Monochrome-type) graphics monitor, you may
experience problems getting the graphics to appear on the screen, or printed
to the printer.  Read the manual appendix on monitors.  Check the file
LATENEWS.DOC for any late news.

You may also set up the path where your data is stored. For example, if the
data is stored in another subdirectory, such as "MYDIR", specify the default
path as "\MYDIR\" or "C:\MYDIR\"

The path will be added to the beginning of filenames used in the program.

##16
                               S H A R E W A R E
                               _________________


                            TRY IT BEFORE YOU BUY IT

The purpose of shareware products is to allow you to try software products
before you buy them.  KWIKGRAF is not a public domain program. Persons who
use KWIKGRAF should become registered users. You receive several benefits
from registration.

1. You help to keep the product growing to meet your needs.
2. You receive the very latest version, with a printed, bound, and expanded
manual.
3. You receive periodic newsletters announcing new releases, and pointing out
important information on any bugs and fixes.
4. You are able to purchase update to new versions for a minimal cost.

Print the file on disk named ORDER to register.  Thanks.

are able